home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 1 / LIGHT-ROM 1 (Amiga Library Services)(1994).iso / ffdisks / d935.lha / LazyBench / LazyBench.doc < prev    next >
Text File  |  1993-12-20  |  19KB  |  421 lines
  1. Distribution
  2.  
  3.      Briefly,  LazyBench is a copyrighted product and  all the rights are
  4.      reserved  to Werther 'Mircko' Pirani (referred  to as "the Author").
  5.      Nonetheless,  LazyBench may  be freely  distributed as  long as  the
  6.      following restrictions are met:
  7.      -  The distributor may only charge a fee up to the cost of obtaining
  8.         a public domain disk from a PD Library.
  9.      -  The distributor agrees to cease distributing  the program and any
  10.         data involved if requested to do so by the Author.
  11.      -  The distributor  may only  distribute an  unmodified copy  of the
  12.         original program,  with all supplied documentation  and copyright
  13.         notices intact. Read the file "License.doc" for more details.
  14.  
  15.      The original distribution includes:
  16.  
  17.           LazyBench.doc            19379 bytes (this document)
  18.           Lazybench.doc.info         745 bytes (its icon)
  19.           LazyBench                18864 bytes (LazyBench for OS 2.xx)
  20.           LazyBench.info             515 bytes (its icon)
  21.           License.doc               7646 bytes (legal stuff)
  22.           License.doc.info           745 bytes (its icon)
  23.  
  24.      If  one or more of  the above is missing,  then your distribution is
  25.      incomplete:  please, dump it immediately and check  it out with your
  26.      favourite  BBS or PD Library. If all else fails,  you can try to get
  27.      in  touch  with me  for a  complete distribution.  Read the  chapter
  28.      "Feedback" for more details.
  29.  
  30.  
  31.  
  32. LazyBench is now Kickstart 2.xx (and hopefully above!) only
  33.  
  34.      I'm  no longer developing and distributing LazyBench for pre OS 2.xx
  35.      Amigas  and so from now on all the new  archives circulating will be
  36.      Kickstart  2.xx only. Anyway, If you need  the simpler LazyBench for
  37.      OS  1.3  you can  find it  on Fish  Disk #  894, on  a Aminet  site,
  38.      perhaps on a BBS near you or directly from me.
  39.      Sorry,  but LazyBench  was born to  be a *small* utility  and simply
  40.      there's  no way  to improve it  on a OS  1.3 machine  without adding
  41.      extra  code or  resorting to extra  libraries. Still, if  you really
  42.      need  it  (and  if  you  ask  nicely)  I may  consider  to  use  the
  43.      reqtools.library  to make  LazyBench for Kickstart 1.3  very similar
  44.      to the 2.xx version.
  45.  
  46.  
  47.  
  48. Introduction
  49.  
  50.      LazyBench  is a  little utility  for lazy  people with  a hard  disk
  51.      crammed  full of goodies, which  are too difficult to  reach because
  52.      they  are  buried  away in  drawers  inside  drawers inside  drawers
  53.      inside drawers ... I could go on and on but ... I'm too lazy!
  54.  
  55.      Laziness  aside, LazyBench adds an item  under the Workbench "Tools"
  56.      menu,  installs  itself  as a  commodity and  quietly  waits in  the
  57.      background.  From now  on, you can  use its hot key  combination (or
  58.      select  the item 'LazyBench' from the "Tools" menu) to open a window
  59.      and  pick  up  an  application  from  an  *unlimited* list  of  your
  60.      favourite   applications  (tools  or  projects)  without  having  to
  61.      reorganize the Workbench!
  62.  
  63.      Such  utilities  are  usually called  "hard  disk  menus" and  while
  64.      LazyBench  is neither  the only  one, nor  the best  available, it's
  65.      tiny  enough (just 18864 bytes)  to fit even in  the most crowded of
  66.      the  hard disks.  Furthermore, it's easy  to configure even  for the
  67.      laziest person in the world!
  68.  
  69.  
  70.  
  71. Installing LazyBench
  72.  
  73.      1) Drag the LazyBench icon in the WBStartup drawer.
  74.  
  75.      2)   Click  once  on  the   LazyBench  icon  and  select   the  item
  76.      'Information...'  from the Workbench "Icons" menu  (or use the Right
  77.      Amiga  - I keyboard equivalent) to edit the  Tool Types according to
  78.      your personal needs and tastes.
  79.      Like  any other commodity, LazyBench deals  with these standard Tool
  80.      Types:
  81.  
  82.      CX_POPUP (internal default: CX_POPUP=NO)
  83.         Use CX_POPUP=YES if you want LazyBench to open its window as soon
  84.         as it's launched.
  85.  
  86.      CX_POPKEY (internal default: CX_POPKEY=ralt help)
  87.         This  is the  hot key  to make  the LazyBench  window appear.  By
  88.         default the  combination is  Right Alt  - Help.  Choose this  one
  89.         carefully  to  avoid  any conflict  with  other  commodities  and
  90.         applications (remember that  this hot key is  *always* active, no
  91.         matter which screen is in  the foreground). Please, refer to your
  92.         "Using The  System Software"  manual and  read the  chapter about
  93.         commodities for more details.
  94.  
  95.      CX_PRI (internal default: CX_PRI=0)
  96.         You can  set the LazyBench priority  by entering a number  in the
  97.         range from -128 to 127 but you'd better stick with a value of 0.
  98.  
  99.      Furthermore, you may want to use these extra Tool Types:
  100.  
  101.      REMEMBER (internal default: NOREMEMBER)
  102.         By default LazyBench opens its window in the upper left corner of
  103.         the visible portion of the  Workbench screen, but you can use the
  104.         Tool  Type  REMEMBER  to  make   LazyBench  "remember"  its  last
  105.         position. That is,  you can pop up its window,  drag it where you
  106.         want and close  it: from the next time  the LazyBench window will
  107.         pop up there.
  108.  
  109.      AUTOHIDE (internal default: NOAUTOHIDE)
  110.         By default  when you launch  an application the  LazyBench window
  111.         stays open and  it's up to you close it when  you're done. On the
  112.         other hand, you can use  the Tool Type AUTOHIDE to make LazyBench
  113.         automatically  close  its  window  as  soon  as  it  launches  an
  114.         application.
  115.  
  116.      EDITOR (internal default: EDITOR=C:Ed)
  117.         LazyBench can invoke the editor of your choice, so you can add or
  118.         remove items from the "LazyMenu" file with no efforts at all. Use
  119.         a string like:
  120.  
  121.         EDITOR=SYS:Tools/Memacs
  122.  
  123.         to  choose the  editor you  feel  more comfortable  with and  let
  124.         LazyBench take care about the rest.
  125.  
  126.      FONTSENSITIVE (internal default: NOFONTSENSITIVE)
  127.         A nice touch  for people who are using a  Workbench screen with a
  128.         font other than the usual topaz 8. If you specify this Tool Type,
  129.         LazyBench will  use whatever  font you've  chosen as  the Default
  130.         Screen Font, otherwise it will stick to topaz 8.
  131.  
  132.      DONOTWAIT (system default: WAIT)
  133.         If you start  LazyBench at boot time and you  omit to insert this
  134.         Tool Type,  the Workbench  won't be  able to  close the  original
  135.         shell and  will ask  you if you  want to wait  some more:  just a
  136.         minor annoyance...
  137.  
  138.  
  139.  
  140. Configuring LazyBench
  141.  
  142.      Create  a file  called "LazyMenu"  in the  S: directory.  This is  a
  143.      plain   text  file,  so  you  can  use  the  editor  you  feel  more
  144.      comfortable  with, from the humble  Ed to a word  processor with all
  145.      the  bells and whistles. LazyBench reads this file to know about the
  146.      applications  (tools  or projects)  you  would like  to have  handy,
  147.      without  messing the  Workbench screen  with many  open drawers  and
  148.      windows.
  149.  
  150.      Actually,  you can  use LazyBench itself  to edit this file.  If you
  151.      start  LazyBench with  no "LazyMenu"  file in  the S:  directory, it
  152.      asks  you if  you want to create  one. Clicking on the  'Yes' gadget
  153.      will  start the editor. Read  the  discussion about  the EDITOR Tool
  154.      Type in the chapter "Installing LazyBench" for more details.
  155.  
  156.      Each   line  in  this  text  file  is  the  full  pathname  for  the
  157.      application  you want LazyBench to launch and each line can be up to
  158.      256 characters in length:
  159.  
  160.      SYS:Utilities/Clock
  161.      SYS:Tools/Calculator
  162.      Work:FinalCopy_II/FinalCopy_II
  163.      Work:NComm/NCommSYS:Work/Games/Amoeba Invaders
  164.  
  165.      Please  note the space within the last line: when  a directory or an
  166.      application  name contains  spaces you  *don't* have  to use  double
  167.      quotes,  just type  the full  pathname as  above. Of  course in  the
  168.      LazyBench  ListView you'll see  just the applications name,  not the
  169.      full  pathnames, so  in this  case you'll  see items  named "Clock",
  170.      "Calculator", "FinalCopy_II", "NComm" and "Amoeba Invaders".
  171.      Please  note that  the only  limit is the  memory available  in your
  172.      system,  so you can have an unlimited  number of applications listed
  173.      in the "LazyMenu" file.
  174.  
  175.      Please also note that you can also use a line of the type:
  176.  
  177.      Work:WriteStuff/Documents/Letter
  178.  
  179.      where  "Letter" it's not an  application (a tool) but  a document (a
  180.      project)  and choosing  the item named  "Letter" from  the LazyBench
  181.      ListView  would  start  the word  processor  used  to write  such  a
  182.      document   and  load  the  file  named  "Letter".  Since  most  word
  183.      processors,   desktop  publishers  and  paint  programs  save  their
  184.      settings  along with the document, you can  start an application and
  185.      load  its preferences  just by  picking an  item from  the LazyBench
  186.      ListView. Neat, isn't it?
  187.  
  188.  
  189.  
  190. Activating LazyBench
  191.  
  192.      LazyBench sits in the background and you can activate it by:
  193.  
  194.      1)  Its  hot  key combination.  No  matter which  screen  is in  the
  195.      foreground,  the hot key combination causes  the Workbench screen to
  196.      come  to  the  foreground and  the  LazyBench  window to  open.  The
  197.      default  is the combination "Right Alt - Help"  (press the Right Alt
  198.      key,  hold it down and press the Help key)  but you are free to pick
  199.      up  the one you prefer. Read the discussion about the CX_POPKEY Tool
  200.      Type in the chapter "Installing LazyBench" for more details.
  201.  
  202.      2)  Selecting the item 'LazyBench' from  the Workbench "Tools" menu.
  203.      This is handy if the Workbench screen is already in the foreground.
  204.  
  205.      3)  Launching  the  Exchange  commodity,  selecting the  item  named
  206.      'LazyBench'  and clicking on the gadget labelled 'Show'. This one is
  207.      pretty awkward, I know, but it's just to let you know! :-)
  208.  
  209.  
  210.  
  211. Using LazyBench
  212.  
  213.      When  you  start  LazyBench  you  are  presented  with a  window,  a
  214.      ListView  and a group of gadgets labelled 'About...', 'Start', 'Edit
  215.      List',  'Hide' and  'Quit'. All these  gadgets can also  be selected
  216.      from  the "LazyBench" menu,  with the Right  Amiga - key equivalent,
  217.      or with a quicker, more straightforward, single key equivalent.
  218.      Please  note that using the  latter method, the action  is performed
  219.      only  when you release the key so, should you change your mind, it's
  220.      possible  to click on any other key (for example,  the space bar) to
  221.      abort the operation.
  222.  
  223.      The ListView
  224.         The ListView is much like  a regular file requester but this time
  225.         the items displayed are the  applications (tools or projects) you
  226.         can launch  from LazyBench and  not files within a  directory. As
  227.         any other regular file requester, you can click on the arrows and
  228.         drag or  click the slider  to scroll the items.  Furthermore, you
  229.         can  use the  unshifted or  shifted up  and down  cursor keys  to
  230.         scroll the  ListView either  by one  item or by  one "page"  at a
  231.         time.  The current  selection  and the  number  of   applications
  232.         launched so  far by LazyBench  are displayed just  underneath the
  233.         ListView.
  234.         The simplest  and quickest  way to  launch an  application is  to
  235.         double-click on a ListView item or to press either the 'S' or the
  236.         ENTER key after you have selected an item.
  237.  
  238.      'About...' (Right Amiga - A) (A)
  239.         Okay, I'm a bit egocentric!
  240.  
  241.      'Start' (Right Amiga - S) (S or ENTER)
  242.         Another way to launch an  application. Click once on the ListView
  243.         to select an item and then click on the 'Start' gadget or use the
  244.         cursor keys and then press  the 'S' or the ENTER key. Please note
  245.         that the 'S' and the ENTER keys are inactive and both the 'Start'
  246.         gadget and the 'Start' item from the "LazyBench" menu are ghosted
  247.         (you can't select them) until  you have not selected an item from
  248.         the ListView.
  249.  
  250.      'Edit List' (Right Amiga - E) (E)
  251.         When  you need  to  add or  remove applications  to  or from  the
  252.         "LazyMenu"  file in  the S:  directory,  you don't  have to  quit
  253.         LazyBench to  update the ListView.  Just click on this  gadget or
  254.         press the 'E'  key to invoke your editor, then  edit the file and
  255.         let LazyBench  close the window,  reload the file and  reopen the
  256.         window, thus updating the ListView. Pheew!!!
  257.  
  258.      'Hide' (Right Amiga - H) (H)
  259.         Click on  this gadget or  press the  'H' key to close  the window
  260.         (same as clicking  on the close gadget in  the upper left corner)
  261.         and to let  LazyBench running in the background.  Use its hot key
  262.         combination or select 'LazyBench' from the Workbench "Tools" menu
  263.         to make its window pop up again.
  264.  
  265.      'Quit' (Right Amiga - Q) (Q)
  266.         The only way  to quit LazyBench. Please note that  the 'Q' key is
  267.         inactive and both the 'Quit'  gadget and the 'Quit' item from the
  268.         "LazyBench"  menu are  ghosted (you  can't click  on them)  until
  269.         applications launched by LazyBench are still running.
  270.  
  271.  
  272.  
  273. Quick Troubleshooting Guide
  274.  
  275.      Due   to   its   simplicity,  LazyBench   doesn't   really  need   a
  276.      troubleshooting  guide. Anyway, if one or more  items are present in
  277.      the  "LazyMenu" file  but are missing  from the  LazyBench ListView,
  278.      you may want to look for one of the following:
  279.  
  280.      1)  Either you've  made a typo or  you have gotten the  pathname for
  281.      one or more of the applications wrong;
  282.  
  283.      2)  The pathname is correct but the application it's neither a tool,
  284.      nor a project. A directory perhaps?!?
  285.  
  286.      3)  The pathname is right and the application is  really a tool or a
  287.      project  but has  no icon. Since  LazyBench purpose is to  launch an
  288.      application  without  having  to double-click  on  its icon,  you're
  289.      definitely  out of luck. How can you  double-click on something with
  290.      no icon at all?!?
  291.  
  292.      Furthermore,  if LazyBench  quits with  the message  "Cannot install
  293.      LazyBench  as a commodity" either  you've entered a hot  key used by
  294.      another  commodity  or you've  entered  an illegal  hot key.  Please
  295.      check  the CX_POPKEY Tool Type  and refer to your  "Using The System
  296.      Software" manual.
  297.  
  298.  
  299.  
  300. LazyBench History
  301.  
  302.      V1.00: February 28, 1993
  303.         - First ever public release.
  304.  
  305.      V1.01: March 7, 1993
  306.         -  Memory  is now  dynamically  allocated  and the  benefits  are
  307.         twofold:
  308.         1) LazyBench uses just the memory it needs, depending on how many
  309.         items a user  wants to display in the  LazyBench ListView and not
  310.         assuming there are 100 of them.
  311.         2) The limit  of up to 100  applications in the ListView  is gone
  312.         and the only limit is the memory available!
  313.  
  314.      V1.02: March 11, 1993
  315.         -  The  'Start'  gadget  is  ghosted until  there  is  a  current
  316.         selection and becomes ghosted again as soon as the application is
  317.         launched. That  is, to use the  'Start' gadget first you  have to
  318.         select an item from the ListView.
  319.         - The 'Quit'  gadget and the 'Quit' item  in the "LazyBench" menu
  320.         become both  ghosted as  soon as  there is  at least  a LazyBench
  321.         launched application: that is, you cannot quit while applications
  322.         started by LazyBench are still running.
  323.         - Added support for the "version" string: the user can tell which
  324.         revision he owns  without starting LazyBench, but  just by typing
  325.         in the Shell window:
  326.  
  327.         version SYS:WBStartup/LazyBench FULL
  328.  
  329.         - Now LazyBench  asks for version 36 (the one  in the Amiga 3000)
  330.         of the libraries  needed, so Amiga 3000  owners should experience
  331.         no problem at all. Sorry: I forgot you!
  332.  
  333.      V1.03: March 14, 1993
  334.         - Rearranged the items in the "LazyBench" menu.
  335.         - Workbench  virtual screens  (screens bigger  than the  physical
  336.         screen)  now are  properly  supported  and the  LazyBench  window
  337.         always pops up in the  upper left corner of the (visible part of)
  338.         the Workbench screen.
  339.         - Added the keyword REMEMBER to the Tool Types: now LazyBench can
  340.         remember where it was placed  last time you closed its window. If
  341.         REMEMBER is not  set, LazyBench always pops up  its window in the
  342.         upper left corner of the (visible part of the) Workbench screen.
  343.  
  344.      V1.04: Apr 8, 1993
  345.         - Added the keyword AUTOHIDE to the Tool Types: now LazyBench can
  346.         automatically close its window after launching an application. If
  347.         AUTOHIDE is not  set, the LazyBench window  stays open. Thanks to
  348.         Bernie Cosell for this suggestion!
  349.         - Rearranged one more time the items in the "LazyBench" menu: now
  350.         all the  LazyBench gadgets (including  'Start') are  available as
  351.         menu items under the "LazyBench"  menu and have keyboard shortcut
  352.         equivalents.
  353.  
  354.      V1.05 - V1.09: Apr, May and June 1993
  355.         -  Just  minor  "internal"  revisions   not  worth  a  standalone
  356.         distribution.
  357.  
  358.      V1.10: June 25, 1993
  359.         - Added the  keyword EDITOR to the Tool  Types: now LazyBench can
  360.         invoke the editor  of your choice to edit  the "LazyMenu" file in
  361.         the  S:  directory  with no  efforts  at  all. Thanks  to  Daniel
  362.         Migueres for this suggestion!
  363.         - Added a couple of  requesters that pop up before any "critical"
  364.         operation.
  365.  
  366.      V1.11: September 4, 1993
  367.         -  Added  the  keyword  FONTSENSITIVE  to  the  Tool  Types:  now
  368.         LazyBench can use  the font selected as  the Default Screen Font.
  369.         Omitting  this keyword  forces LazyBench  to stick  to the  usual
  370.         topaz 8 font.
  371.  
  372.      V1.12: October 10, 1993
  373.         -  Now every  gadget as  a single  key equivalent  denoted by  an
  374.         underscore. Furthermore,  the cursor keys  can be used  to scroll
  375.         the ListView either by one  item or by one "page" at a time using
  376.         the shift keys.  The ENTER key can be used just  like the 'S' key
  377.         or  the   'Start'  gadget  to   launch  the   currently  selected
  378.         application, so  there's no really need for a mouse!
  379.  
  380.  
  381.  
  382. Feedback
  383.  
  384.      LazyBench  is freely distributable and so I'm  not asking for money.
  385.      Anyway,  if you  are using LazyBench I'd  like very much to  hear it
  386.      from   you.  Suggestions,   bug  reports,  positive   criticism  and
  387.      contributions are welcomed at the following addresses:
  388.  
  389.           internet:   werther@karunko.nervous.com
  390.           fidonet:    2:335/602.12 (Mirko Pirani)
  391.           amiganet:   39:102/1.12  (Mirko Pirani)
  392.  
  393.      If  all else  fails you can  always reach me  by snail mail  (even a
  394.      simple postcard will do):
  395.  
  396.           Werther 'Mircko' Pirani
  397.           Via Mario Torresi, 74
  398.           60128 Ancona
  399.           ITALY
  400.  
  401.  
  402.  
  403. Dedicated to
  404.  
  405.      Mila, Yaya, Tina, Biba and Betty: Wish you were here.
  406.  
  407.      Laura: ...Just in the nick of time!
  408.  
  409.      Steve  B. from  Bernardones. Their brand  new "Mondo  Buzzurro" demo
  410.      tape is due very soon now. You've been warned! :-)
  411.  
  412.      Anyone who has taken the time to get in touch with me. Thanks!
  413.  
  414.  
  415.  
  416.  
  417.  
  418.      October 10, 1993
  419.  
  420.      Werther 'Mircko' Pirani
  421.